home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 25 / AMIGAplus Sonderheft 25 (2000)(Falke)(DE)(Track 1 of 4)[!].iso / Tools / SFX-Player / Mpeg / mpegaplayer / MPEGAPlayer.doc < prev   
Text File  |  2000-05-08  |  9KB  |  272 lines
  1. -------------------------------------------------------------------------------
  2.  
  3.                         MPEGAPlayer 2.55 (17-Mar-1998)
  4.  
  5. -------------------------------------------------------------------------------
  6.  
  7.  
  8. Distribution Conditions
  9. -----------------------
  10.  
  11.   This program is copyright (c) 1995-97 by Stephane TAVENARD.
  12. It may be distributed freely under the condition that no profit is
  13. gained from its distribution, nor from any other program distributed
  14. in the same package.
  15.  
  16.   Permission is granted to distribute this package by Bulletin Board
  17. systems or network sites, under the condition that no fee is charged
  18. on downloading it.
  19.  
  20.   All files that are part of this package have to be distributed
  21. together and none of them may be changed in any way other than
  22. archiving or crunching.  The only exception to this rule are the
  23. icons, including the tooltypes, which may be changed to accommodate
  24. them to the rest of the disk it is distributed on.
  25.  
  26.   This program is distibuted as giftware.
  27.  
  28.  
  29. Disclamer
  30. ---------
  31.  
  32.   This package is provided "as is" without warranty of any kind.
  33. The author assumes no responsibility or liability whatsoever
  34. for any damage or dataloss caused by using this package.
  35.  
  36.  
  37. Introduction
  38. ------------
  39.  
  40. What is MPEG audio ?
  41.  
  42. It's a very efficient audio compression standard. Actually, there are 3 methods
  43. of compression named Layer I, II & III. Layer III is more efficient than
  44. Layer II and layer II is more efficient than layer I :) .
  45. MPEG audio allow to compress a 16-bits PCM sound file from 1.2 to 32 times.
  46.  
  47.  
  48. Why is it so hard to make a real time MPEG audio decoder ?
  49.  
  50. MPEG audio decoding requires a lot of arithmetic calculation, so a lot of CPU
  51. power is required. Normally, MPEG audio decoding is made with help of a DSP.
  52.  
  53.  
  54. History
  55. -------
  56.  
  57. V1.0    11-Jun-1995     First release (not public)
  58. V1.1    19-Jun-1995     Corrected minor bug in audio signal allocation
  59. V1.11   09-Jul-1995     Asynchronous Config window & Screen locking bug corrected
  60. V1.2    10-Sep-1995     Added mixing frequency for audio output
  61.         07-Feb-1996     68060 version not optimized
  62. V1.3    01-Jul-1996     Fixed a bug in the check routine
  63.                         Corrected old bug that kill my prog
  64. V1.4    28-Dec-1996     Correct bug in Config save ! (very old bug...)
  65.                         Now supports MPEG-2 Layer1&2
  66.                         Now Scopes Genies works !
  67.                         Added Volume/Balance/Faster/Slower/Prev/Next
  68.                         Use Christian Buchner 14-bit calibrated audio
  69. V1.41   17-Feb-1997     Added Audio buffer time config (1/4 sec to 2 secs)
  70.                         Added High priority config
  71. V1.42   27-Feb-1997     Added Boost Volume option in config
  72.  
  73. V2.00   05-May-1997     Major release (Player is now in 'C')
  74.                         Added MPEG layer III
  75.                         Improved multitasking
  76.                         Added AHI (V4)
  77.                         No more 8 bit output
  78.                         New Configuration
  79. V2.10   16-May-1997     Improved Audio manager (and fixed 'skipping' bug)
  80.                         Fixed bugs in memory allocation
  81.                         Audio Filter is not changed by player any more
  82. V2.20   18-May-1997     Fixed bug in Audio reset
  83.                         Improved MPEG Decoding (20% faster on 060)
  84. V2.30   24-May-1997     Fixed bug that crashed player when start playing.
  85.                         New Audiomanager (uses soft interrupts)
  86. V2.35   29-May-1997     Fixed play/pause function (bug in V2.30)
  87.                         Gain of 6% for Layer III decoding (on '060)
  88. V2.40   16-Jul-1997     Enhanced Status Window (time bar now !)
  89.                         Use Async I/O
  90.                         Gain of 5% for Layer III decoding (on '060)
  91.                         Separate setting for Layers I&II and Layer III
  92. V2.45   16-Aug-1997     Fixed a bug in Audiomanager (AHI mode)
  93.                         Fixed some bugs in windows show/hide
  94. V2.50   13-Dec-1997     Use now mpega.library (available in aminet/util/libs)
  95.                         Only one CPU version (use the mpega library version for your CPU)
  96.                         Enhanced MPEG Audio files checking
  97.                         Added Boost Volume in Status window option
  98.                         Added Loading in RAM option
  99.                         Added Pattern for MPEG Audio files
  100. V2.55   17-Mar-1998     Show title of MPEG TAG
  101.                         Show MPEG format & duration in Module Info
  102.                         Show MPEG TAG infos in status window
  103.  
  104. Description
  105. -----------
  106.  
  107. This is a player for DeliTracker program (thanks to Peter Kunath and
  108. Frank Riffel for this marvellous soundplayer). You need at least a
  109. 68020 CPU to use it ! This player can decode and play standard
  110. MPEG audio bitstreams, layers I, II & III.
  111. Audio output can be made whit my internal paula driver (14 bits)
  112. or with AHI device (you need at least V4 of AHI)
  113.  
  114. How to use it ?
  115.  
  116. First, get a version of DeliTracker (best: get the latest version).
  117.  
  118. Second, install mpega.library (available in aminet in util/libs)
  119.  
  120. Then, copy the player file 'MPEGAPlayer' in the DeliPlayer directory.
  121.  
  122.                        ***** WARNING *****
  123.  
  124.    THE FPU VERSIONS ARE NOW FULL FPU CODED, THEY PROVIDE BETTER
  125.        SOUND QUALITY, BUT THEY ARE SLOWER THAN NON FPU ONES.
  126.  
  127.                        ***** WARNING *****
  128.  
  129. Last, start DeliTracker and try to load an MPEG Audio file:
  130.  
  131. You don't hear anything:
  132. -> there's a bug ?
  133.  
  134. You hear a some sound broken with blanks:
  135. -> Your CPU is not enough faster for the current options.
  136.  
  137. You hear a countinous sound (10 sec):
  138. -> Ok, you've got a good CPU, try to find long MPEG file now.
  139.  
  140.  
  141. Options
  142. -------
  143.  
  144. In the player option window of DeliTracker, select Config button.
  145. Then you can configure the MPEG decoder for mono and stereo files
  146. separately (why ? because decoding time of stereo files is approx.
  147. 2x decoding time of mono files). Config. options are:
  148.  
  149. The decoding options are separated for MPEG Layers I & II and
  150. Layer III.
  151.                Mono & Stereo file
  152.                ~~~~~~~~~~~~~~~~~~
  153.  
  154. Qual (Quality): High, Medium, Low
  155. ~~~~~~~~~~~~~~
  156. -> defines the decoding quality, and also the decoding speed.
  157. Slow CPU users, select Low quality ...
  158.  
  159. F.Max (Freq Max): 4000..48000
  160. ~~~~~~~~~~~~~~~~
  161. -> defines the maximum output decoding frequency.
  162. If the frequency of the file to decode is greater than the 'Freq Max'
  163. specified, the decoder divide by 2 or by 4 in order to have a
  164. decoding frequency just bellow 'Freq Max'
  165. Slow CPU users, set this value to 12000 (div by 4) or 24000 (div by 2)
  166. For Fast CPU, you can set this to 48000 in order to never divide
  167. output frequencies.
  168.  
  169. Note: 'Freq Max' allows better setting than the 'Frequency' selector
  170. of the older releases.
  171.  
  172. Force mono:
  173. ~~~~~~~~~~
  174. For stereo files, it's possible to play them in mono (save a lot of CPU time)
  175. when selecting 'Force Mono'
  176.  
  177.  
  178.                Miscellaneous
  179.                ~~~~~~~~~~~~~
  180. Scopes:
  181. ~~~~~~
  182. When disabled, the player don't make calculation for the scopes, so it can
  183. save some usefull power on Slow CPU !
  184.  
  185. Status Win.:
  186. ~~~~~~~~~~~
  187. When enabled, the status window is automatically opened when an mpeg audio
  188. file starts to play.
  189.  
  190. Status TAG:
  191. ~~~~~~~~~~
  192. When enabled, the status window show the MPEG TAG ID's if present in stream
  193.  
  194. Load in RAM:
  195. ~~~~~~~~~~~
  196. If enabled, try load the entire file to play in RAM. If there is not enough
  197. free RAM, the file is played from disk.
  198.  
  199. Pattern:
  200. ~~~~~~~
  201. Only files that matches this pattern will be checked for MPEG Audio.
  202.  
  203. Priority:
  204. ~~~~~~~~
  205. Allows to set the player's priority from -9 (low) via 0 (normal) to 19 (high).
  206. Set it to 19 if you don't want to have audio 'holes' when using others
  207. applications that need a lot of CPU.
  208. A value of 3 is a good value for a player.
  209.  
  210. Buffer:
  211. ~~~~~~
  212. Specifies the amount of decoded audio samples to keep in memory.
  213. 3 secs is a good value.
  214.  
  215.  
  216.                Audio
  217.                ~~~~~
  218. Enable AHI:
  219. ~~~~~~~~~~
  220. If not checked, use the internal PAULA driver (use 14 bit calibrated audio output)
  221. If checked, use AHI driver, you can then choose an audiomode by clicking on
  222. 'Get AHI Mode' ...
  223.  
  224. Mixing:
  225. ~~~~~~
  226. If not checked, the audio output frequency is the same as the dec